home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 11 / AMUG BBS in a Box Volume XI (April 1994) (MacWizards).iso / Files / Game / M / Minaret.sit / Minaret.doc next >
Encoding:
Text File  |  1988-03-15  |  9.7 KB  |  203 lines  |  [TEXT/MACA]
  1.                          Minaret
  2.                          -------
  3.  
  4. This program computes Islamic prayer schedules, the direction of 
  5. the Qibla, and various data related to the Hijri calendar.
  6.  
  7. You may freely give copies of this program to others.  Since the 
  8. program contains an editable data base, please save a backup 
  9. copy, and use only a working copy to do your computations.  Please 
  10. give only unmodified copies to others, and include this 
  11. documentation with the program.
  12.  
  13. If you decide to keep the program for yourself, please send $10 to:
  14.  
  15.               Kamal Abdali
  16.               2800 NW Eastway Court
  17.               Beaverton, Oregon 97006
  18.               USA.
  19.  
  20. Please send your suggestions and bug reports to me at the above 
  21. address.
  22.  
  23.                        The Place menu
  24.                        --------------
  25.  
  26. This is the first menu you should look at.  Minaret contains a 
  27. built-in gazetteer with geographical information about 170 cities 
  28. initially.  At any time, one of these is the "Current Location" 
  29. for which all computations are done.  To specify any location as 
  30. the Current Location, click on the "Select location" item in the 
  31. "Place" menu.  A large window will appear in which the list at 
  32. left is the gazetteer.  As you scroll through this list and click 
  33. on various location names, the stored data about them appears in 
  34. the boxes at right.  If your desired location is in the gazetteer, 
  35. select it, then press "Make it Current Location".  All subsequent 
  36. computations will be done for that city, even when you exit and 
  37. relaunch Minaret.
  38.  
  39. You can edit the gazetteer to add and delete locations, and to 
  40. modify information about existing locations.  By editing the boxes 
  41. and setting radio buttons at right, you can supply the geographical 
  42. data about the cities you wish to add.  You will need to know the 
  43. latitude, longitude, zone time relative to Greenwich, and whether 
  44. or not the place observes Daylight Savings Time.  After filling in 
  45. the information for each city, press "Update/add this location".  
  46. To delete a location, select it in the gazetteer, then press "Remove 
  47. this location".  Only 200 cities are allowed in the gazetteer.  
  48. So you may need to delete some locations to make room for others.  
  49. You can find out how many cities are already in the gazetteer by 
  50. selecting the "Gazetteer size" item.
  51.  
  52. Note: Editing the gazetteer doesn't change the current location.  
  53. If you want to do computations for a city not in the gazetteer, 
  54. first edit the gazetteer to add that city, then make the city the 
  55. Current Location.
  56.  
  57.                    The Prayer Hours menu
  58.                    ---------------------
  59.  
  60. Select "Prayer hours for today" or "Prayer hours for another day" 
  61. to get the five prayer hours plus the time of sunrise.  (Be sure 
  62. to first set your location using the "Place" menu.)
  63.  
  64. Select "Prayer hours for a month" or "Prayer hours for a year" to 
  65. display a table of prayer hours in a text window.  You can print
  66. the contents of the text window in front by "Print" in the "File"
  67. menu.  By using the "Save" or "Save as" item in the "File" menu,
  68. you can save the contents of the text window in front into a file,
  69. for possible reformatting with a word processor.  If you use MacWrite
  70. only for printing this file , then set the font to Monaco (or some
  71. other monospaced font) before opening the file.  This will keep
  72. the tabular columns neatly aligned.
  73.  
  74. Since prayer hours depend upon the sun's position, it is more 
  75. practical to tabulate the Islamic prayer schedule according to 
  76. the dates in the Western, solar calendar.  For a fixed location, 
  77. prayer times for any particular date in the Western calendar vary 
  78. very little from year to year, and for all practical purposes 
  79. repeat themseleves in four year cycles.  (Find this out for 
  80. yourself by computing prayer hours for the same dates in different 
  81. years.)  If you want to print annual prayer schedules, I strongly 
  82. recommend using zero for the year.  This doesn't mean the year zero
  83. B.C. or A.D., but is a special value to cause Minaret to print a
  84. "perpetual" calendar in which the times are essentially the average
  85. for the four years of a cycle.  It is silly to print a new calendar
  86. every year, since the yearly variation is seldom more than two minutes.
  87.  
  88. If, according to the gazetteer, the Current Location observes 
  89. Daylight Saving Time, then Minaret adds one hour to all times 
  90. computed for the dates between the first Sunday of April and the 
  91. last Saturday of October (inclusive).  If the year is zero (that 
  92. is, if a perpetual schedulae is desired), then the adjustment is 
  93. made throughout from April to October.  
  94.  
  95. Islamic prayer times are computed from their well-known astronomical 
  96. definitions.  (See, for example, the appendices A and B in "Prayer 
  97. Schedules for North America", American Trust Publications, 
  98. Indianapolis, Indiana, 1978.)  Under certain conditions (for 
  99. example, on certain summer dates at very high latitudes), the 
  100. traditional astronomical definitions do not work, and the equations 
  101. defining prayer times do not have solutions.  Minaret prints "??" 
  102. when it cannot compute a  prayer time.  (See also the description 
  103. of "Method" menu below.)
  104.  
  105.                       The Qibla menu
  106.                       --------------
  107.  
  108. Select "Angle from North" to find the direction of the Qibla.  
  109. (Be sure to first set your location using the "Place" menu.)  
  110. The angle is given from the geographical, not magnetic, North.  
  111. Since it is not always easy to accurately either determine North 
  112. or measure angles, the "shadow method" described below is generally 
  113. a better way to determine the Qibla.
  114.  
  115. The "Shadow diagram for a day" lets you determine the Qibla by 
  116. observing shadows, without having to know the North direction.  
  117. You get a diagram which shows the directions in which  the shadow 
  118. of a vertical object points at certain times of the day.  One of 
  119. the lines in the diagram is marked with a Q.  This is the direction 
  120. of the Qibla.  The times have been so computed that the angle between 
  121. the Qibla and the shadow is a multiple of 45 degrees, quite easy 
  122. to measure.  (If there is a time on the line marked Q, then the 
  123. Qibla is exactly in the same direction as the shadow at that time, 
  124. and you don't have to measure any angle.)  Experiment with this 
  125. menu using different dates to see the relation between the Qibla 
  126. and the shadow.  Summer dates give you more opportunities to determine 
  127. the Qibla using the shadow method.
  128.  
  129. Select "Shadow chart for a month" or "Shadow chart for a year" 
  130. to display tables of the shadow information in a text window.
  131. See remarks under "the Prayer menu" for printing and saving the
  132. contents of the window.  
  133.  
  134.                       The Calendar menu
  135.                       -----------------
  136.  
  137. Select "Date conversion" to convert Hijri dates into Western 
  138. ones, and vice versa.  The conversion is approximate, based 
  139. on the assumption that on the average the lunar cresecent 
  140. becomes visible 24 hours after the astronomical new moon phase.
  141.  
  142. Select "New moon phase" to get the time of the astronomical 
  143. new moon phase just preceding the start of any Hijri month.  
  144. Minaret computes the time of this phenomenon with an accuracy of 
  145. about three minutes, and gives it to you both as the Greenwich Mean 
  146. Time and as the Zone time for the Current Location.  Remember 
  147. that the moon is invisible at the astronomical new moon phase, 
  148. and the formation of the visible lunar crescent takes anywhere from 
  149. about 18 to about 42 hours.
  150.  
  151. Select "Moon's age" to determine the age of moon at any desired 
  152. time.  To guess whether the lunar crescent will be visible on a 
  153. certain evening, you can find the time of sunset on that date by 
  154. selecting "Prayer schedule for another day" in the "Prayer hours"
  155. menu, then find the moon's age at that time by selecting "Moon's 
  156. age" in the "Calendar" menu.  If the age turns out to be less 
  157. than 18 hours, then it is quite unlikely that the crescent will 
  158. be visible that evening.
  159.  
  160.                        The Method menu
  161.                        ---------------
  162.  
  163. There are some variations in the methods people use to compute 
  164. certain prayer times.  This menu lets you select the methods 
  165. according to your preference.
  166.  
  167. The "shadow ratio" for a vertical object at any time is defined 
  168. to be the quantity:
  169.  
  170.   (the length of shadow at the given time - the "residual" shadow of 
  171.    the object at noon) / (the object height).
  172.  
  173. The shadow ratio at 'asr time is taken to be 2 by the Hanafi school, 
  174. 1 by others.
  175.  
  176. For fajr and isha, the time is usually determined by the Sun's 
  177. angle of depression below the horizon.  If this value is taken to be
  178. 18 degrees, then fajr coincides with the astronomical twilight.  This
  179. seems OK for temperate latitudes.  But at higher latitudes, say above
  180. 42 degrees, the resulting times for fajr and isha are too inconvenient
  181. (fajr too early, and isha too late).  ISNA schedules are computed by
  182. taking this value as 15 degrees.
  183.  
  184. At latitudes higher than 50, such as for cities in Northern Europe,
  185. the sun sometimes doesn't descend sufficiently below the horizon to
  186. make the determination of fajr and isha possible by taking the value
  187. of the sun's depression to be 18 (or evne 15) degrees).  So people
  188. in some of those cities compute the fajr and isha times to be at 90
  189. minutes from sunrise/sunset.  For latitudes above 66 1/2, of course,
  190. even sunrise and sunset are not always defined.
  191.  
  192.                          The File Menu
  193.                          -------------
  194.  
  195. Use this menu to open, save, and print the monthly or yearly prayer
  196. schedules and qibla charts computed by Minaret.  When text files are
  197. printed using "Print" in this menu, the RETURN (ascii 13) and FORMFEED
  198. (ascii 12) characters will cause line skip and page eject, respectively.
  199. The "File" menu is intended only for use with the text files generated
  200. by Minaret.  In particular, it will not work on non-text files or large
  201. text files (more than 32K characters).
  202.  
  203.